home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 2004 #6 / Amiga Plus CD - 2004 - No. 06.iso / AmiSoft / Comm / mail / YahooGpScan1_5.readme.txt < prev   
Text File  |  1978-04-17  |  6KB  |  144 lines
  1. Short:    Strips YahooGroup adverts.         V1.5
  2. Author:   (C)2000-04 Steve Bowman (Steve & Ulli Bowman <stevebow@hotkey.net.au>)
  3. Uploader: Steve Bowman (Steve & Ulli Bowman <stevebow@hotkey.net.au>)
  4. Version:  1.5 (29-May-2004)
  5. Type:     comm/mail
  6. Replaces: comm/mail/eGroupsScanner.lha
  7. Replaces: comm/mail/eGroupsScan1_0.lha
  8. Replaces: comm/mail/YahooGpScan1_2.lha
  9. Requires: YAM 2+, AWNPipe: & ClassAct if you have OS3.1 or earlier.
  10.  
  11. As anyone who is a subscriber to any YahooGroups' mailing lists (or
  12. "groups") would know, each message distributed by Yahoo comes with a few
  13. lines of advertising appended to each and every message.
  14.  
  15. Although high capacity harddrives nowadays makes the problem of disk
  16. space lost to this advertising less of a concern, it is unsolicited
  17. advertising nevertheless, and it is so much nicer to be able to read
  18. people's messages in their original form without the constant sight
  19. of unsolicited advertising appended to their sig :^).
  20.  
  21. This started out as a very basic script, but I just kept adding and adding to
  22. it.  I have done extensive testing, and although it works fine on my setup
  23. it may not on yours.  Please report any problems.
  24.  
  25. FEATURES:
  26.  
  27. · Tested with OS4.
  28. · OS4 Reaction (ClassAct) GUI with progress bar and info on number of messages
  29.   scanned and adverts stripped.
  30. · Will locate the Incoming Folder regardless of its actual name or postion in
  31.   the folder list or language (I hope...) YAM is running in.
  32. · Will only scan mails flagged as New in the Incoming Folder - because if
  33.   you're anything like me you will usually have ~50 Read mails in your incoming
  34.   folder waiting to be manually archived :^).
  35. · If no new mails are downloaded from the server, no scanning at all takes
  36.   place.  If there are new mails downloaded, only these new mails are scanned.
  37. · Intelligent scanning - if any new messages are not YahooGroup messages, they
  38.   will be skipped.
  39. · After updating Incoming Folder index, returns you to your previous
  40.   folder/state before script exits.  For example, if you have selected a number
  41.   of messages to be deleted in a folder and the script starts after a download,
  42.   you will be restored to that folder with the messages reselected when the
  43.   script terminates.
  44.  
  45. Some people have queried my method of handling the Incoming folder externally
  46. of Yam instead of going through Yam's ARexx port.  I tried and tested both
  47. methods and found that for  most (but not all) cases, analyzing the Incoming
  48. folder was quite a lot slower than doing it directly via AmigaDOS commands.
  49.  
  50. Note that there is a long-standing bug introduced into later versions of YAM
  51. necessiating updating the Incoming Folder index twice.  When this bug is fixed,
  52. scanning will only need to be once.  It is recommended to clean your Incoming
  53. Folder regularly ;^).
  54.  
  55. INSTALLATION:
  56.  
  57. To install, simply copy this script to YAM:Rexx.  Now open YAM's Config panel
  58. and go to the ARexx section.  Hilite the "After getting new mail" item and load
  59. "Rexx/YahooGroupsScanner.rexx" into the Script gadget.  Double check the Pop-up
  60. selector is on ARexx and not AmigaDOS.  Leave "Open console window unchecked,
  61. but (IMPORTANT) make sure "Wait for termination" is checked ON.  Click on Save,
  62. and that's it.
  63.  
  64. *Important* - The AWNPipe: device *must* be installed!  Download the latest
  65. AWNPipe: from http://web.ukonline.co.uk/awnpipe , in the Download section.
  66.  
  67. If you do not have OS3.5+, you will need ClassAct.  AFAIK the final ClassAct
  68. archive prior to OS3.5 can be found at http://members.home.com/taston/classact
  69. but this is quite old compared to the more recent replacement found in OS3.5+,
  70. Reaction.
  71.  
  72. HISTORY:
  73.  
  74. V1.5 (29-May-2004)
  75. · Yahoo changed the advert separaters slightly
  76.  
  77. V1.4 (17-Feb-2003)
  78. · YAM 2.4dev introduced a significant change to the way a message's
  79.   status is represented.  This update accomodates this change.
  80.  
  81. V1.3 (07-Sep-2001) - not publicly released
  82. · Improved YAM config file parsing
  83. · Added more error messages
  84.  
  85. V1.2 (28-Jul-2001)
  86. · Changed the banner seperation identifier code.
  87.  
  88. V1.1 (30-Jan-2001)
  89. · Updated for use with YahooGroups after they took over eGroups
  90.   Note: script name is now YahooGroupsScanner.rexx.
  91. · Window title shows when Incoming folder is being updated after the scanner
  92.   has finished
  93.  
  94. V1.0 (21-Oct-2000)
  95. · GUI now autocloses on completion of scan
  96. · Abort is now working
  97. · Locates .config file in user directory, not just YAM:
  98. · There was a report of the script failing when the To: contents were mixed
  99.   upper and lower case.  Fixed.
  100. · Corrected installation docs which indicated the wrong filename and confused
  101.   a few people, sorry.
  102. · GUI is now not active when it opens
  103.  
  104. V0.13ß (18-Sep-2000)
  105. · Original release
  106.  
  107. THINGS TO DO (MAYBE):
  108.  
  109. · Open GUI on Yam's own screen, currently opens on default screen.
  110. · Faster analysis of Incoming folder
  111. · Scanning of archived old mail.
  112. · Preferences for scanning other non-YahooGroups mail.  Currently only messages
  113.   from YahooGroups with their current seperater pattern is used.
  114. · German and other language translation (localization?) of program text and
  115.   docs.
  116. · Strip HTML attachments.
  117. · Any requests???
  118.  
  119. THANKS
  120.  
  121. Thanks to the following people in alphabetical order for help or suggestions.
  122. Apologies for anyone I've missed - please let me know if I have have.
  123.  
  124.    Matteo Cavalleri
  125.    Javier de las Rivas
  126.    Emilio Desalvo
  127.    Sebastian Jedruszkiewicz
  128.    Bill Parker
  129.    Mark Reynolds
  130.    Krister S. Skrtic
  131.    Bruce Steers
  132.  
  133. ...and to the many others who just wrote and thanked me.
  134.  
  135. DISCLAIMER:
  136.  
  137. · This script is to be used entirely at your own risk, and although I have
  138.   performed extensive testing, I will not be held responsible for any loss of
  139.   data as a result of its use.
  140. · This script is ©2000-03, and may only be distributed in its original
  141.   unmodified form.
  142.  
  143. If you disagree with any of the above, do not use the script!
  144.